ICEPIC USER'S GUIDE ADDENDUM
Summary of Changes
ICECO has made many enhancements to the ICEPIC software since the user's guide was
printed. Some of these changes will alter the procedures described in the user's
guide — these are detailed below and should be noted in your guide.
IMPORTANT !! NOTE the CHANGES to the TUTORIAL, page 6.2 and to the Sample
Application Requirements, Page 10.1.
There are five major areas of enhancement: first, drivers are now supplied for all
joystick ports (not just 2 and 4); second, a configuration program is included to
make it much easier to select a driver and copy it to another diskette; third,
XL/XE versions of the drivers are provided (which use no additional memory);
fourth, new PHANDLER drivers which use page 3 and 4 are included; and lastly, the
ICEGRAF drivers on the software diskette are ready-to-load for port 2 only — the
CONFIGUR program must be used to generate ICEGRAF drivers for the other ports.
User's Guide Changes
Page 6.2, ICEGRAF Tutorial Step 1: Connect your ICEPIC to port 2.
Page 6.2, ICEGRAF Tutorial Step 5: Load ICEGRAF.02H if you have an OKIDATA
^compatible graphics printer, otherwise, loaitJCEGRAF.E2H.._ ___
Page 10.1, Sample Application Requirements, second paragraph: The selection
criteria for all of the sample applications is built into CONFIGUR — just tell it
your machine configuration plus the application you need and it will do the rest.
If you have special needs, it will allow you to change the sample versions or to
completely specify your own. The descriptions in the manual and below tell you
what CONFIGUR will select for you — you will not have to follow the steps listed
to create your driver since CONFIGUR does them automatically.
Page 1.3, Equipment Needed: ICEPIC also works on 130XE models.
Page 2.1, Hardware Setup: Step 3: You may plug the ICEPIC into any joystick
jack. Step 4: If your printer has a 7/8 bit interface setup switch, make sure it
is in the 8-bit position.
Page 2.3, Checkout Procedure: Use ICECHK1 for joystick port 1 or 1CECHK3 for
joystick ports 3.
Page 3.3, Picking the Driver You Need: Load CONFIGUR from the ICEPIC software
diskette to select, copy, rename, etc., the driver you need (for more details see
the description of CONFIGUR below).
Page 3.3, Self-Booting Programs: The XL drivers implement a special "re-boot key"
— while holding any key except SHIFT or CTRL, press [BREAK] and a re-boot will
occur (the drivers will remain active).
-_ i -
Page 3.3, System Reset: The page 3/4 drivers (nCB and nPS), high memory PHANDLER
and SIOSIM drivers, and the XL drivers will be lost during normal system reset.
The XL versions implement a special reset function ~ instead of [RESET], press
[SHIFT]-[BREAK] and a system reset will occur without loss of the drivers.
Page 4.1, PHANDLER versions: There are 18 versions of PHANDLER:
. PHANDLER.nLM loads in low memory.
. PHANDLER.nHM loads in high memory.
. PHANDLER.nXL works with XL/XE models, replacing the OS cassette handler.
. PHANDLER.nPS loads in the print buffer and the second half of page 4.
. PHANDLER.nCB loads in the print buffer and the cassette buffer (first half
of page 4).
"n" can be 1, 2, 3, or 4 depending on which joystick port is in use. CONFIGUR
will make it easy to select the proper version to meet your needs; it must be
used to generate the XL versions.
Page 4.2, SIOSIM versions: There are 12 versions of SIOSIM: 4
. SIOSIM.nLM loads in low memory.
. SIOSIM.nHM loads in high memory. ^ q
. SIOSIM.nP6 loads in page 6. v . ;
The XL version of PHANDLER also includes the code for SIOSIM. CONFIGUR
should be used to select the SIOSIM version you need.
Page 6.1, ICEGRAF versions: There are 20 possible versions of ICEGRAF (only the
port 2 versions are on the diskette in ready-to-load format, CONFIGUR must be used
to generate the other versions). In addition to those listed on page 6.1, there
are versions for port 1 or 3, plus XL/XE versions. The XL/XE version loads into
high memory and if BASIC is present, it "hides" under it in RAM (appears to use no
memory) and will be swapped active whenever it is needed — a portion of the
driver loads into the cassette handler code in OS to make the swap. The XL
version MUST be generated by CONFIGUR; for best results, CONFIGUR should be used
to generate any ICEGRAF driver.
Page 7.1, Status Locations and Values: Port 1 Addresses are STRIG(O), PADDLE(O),
and PADDLE(l). Port 3 addresses are STRIG(2), PADDLE(4) and PADDLE(5).
Page 9.1, ICECHK Diagnostic: ICECHK 1 for port 1 and ICECHK3 for port 3.
Page 9.3: REBOOT will not clear a page below 7 if it contains an ICEPIC driver.
The REBOOT function is built into the XL drivers.
Page 9.4, New Utility Programs:
CONFIGUR is a menu-driven selection program which performs the selection, copying,
appending, and renaming of driver programs. To use it, load CONFIGUR from the
ICEPIC diskette, make your desired selections, and insert your target diskette
when CONFIGUR calls for it. CONFIGUR will allow you to select drivers by
application (for the sample applications) or you can specify your own custom
„- 2 -
requirements. It is quite friendly and allows you to change your mind and back up
at any point. It has only a few limits: the ICEPIC software diskette must be in
drive 1 and any application which is being appended to an ICEPIC driver must
reside on the target diskette or be on another drive (DO NOT SWAP diskettes during
the append operation). CONFIGUR must be used to generate XL drivers and to
generate ICEGRAF for any port except 2 — we recommend that CONFIGUR always be
used, it greatly simplifies the job of selecting and copying a driver. CONFIGUR
always writes a driver named ICEPIC. TMP and when this completes, it renames it to
your specified name (and it lets you rename or delete any program which previously
exists under that name). This mode of operation assures that nothing is lost if
an error occurs and allows you to append an existing program to a driver and
create a new program with the same name as the original (AUTORUN.SYS, for
example). You should always save (via CONFIGURE rename option) any application
program you append and replace — if you need to create a new driver you will need
the original program (DO NOT "reuse" an ICEPIC driver as an appended program).
The RAMOS program copies the XL/XE operating system (OS) from ROM into RAM and
makes several modifications to it. CONFIGUR appends XL drivers to RAMOS to create
the driver you request. The modified OS implements the [BREAK] functions for
system reset and reboot (see Page 3.3 above) ~ this is required because the
normal [RESET] key will always switch OS back into ROM and turning the power off
will clear RAM. To make sure you can press [BREAK], it will be enabled at all
times ~ some applications may try to disable it, but probably will not succeed.
DO NOT press [OPTION] during a reboot, the original power-up BASIC mode (active or
not) will be maintained, but it cannot be changed. RAMOS will also disable the
cassette handler — cassette I/O should not be used with the XL/XE drivers (the XL
drivers are loaded into the memory normally used by the cassette handler). RAMOS
will only work with the standard Atari XL/XE ROM OS — it cannot be used with
translator's, ROM "fixers", or any program which itself modifies OS (on purpose
like PaperClip, or by accident(?) like Print Shop).
Page 10.1, BASIC Programs: On XL/XE models, the XL version of ICEGRAF is best, it
does everything and costs nothing — CONFIGUR must be used to make it.
Page 10.3, LJK Letter Perfect: Step 1: Use SIOSIM.nHM; on XL/XE models use
PHANDLER.nXL. Step 2: For XL/XE, press "reboot" key (see page 3.3 above). Step
3: not needed, (the driver will be lost on [SYSTEM RESET]; on XL's, use
[SHIFT ]-[BREAK] for reset). ICEGRAF can still be used, as documented; however, it
uses 4096 bytes of memory while SIOSIM.nHM will only use 512 bytes and the XL
version uses no additional memory.
Page 10.3, B/GRAPH, Step 1: On XL/XE models, use the XL version of ICEGRAF (use
CONFIGUR to make it) — all of the ICEGRAF functions will be available while
Page 10.4, Koala, disk based, Step 4 should read "Copy IGEGRAF.xnH ...".
Page 10.5, new sample applications:
Print Shop ~ use PHANDLER.nPS plus REBOOT.
PaperClip — use PHANDLER.nP6 plus REBOOT.
- 3 -